home *** CD-ROM | disk | FTP | other *** search
/ PC World 2007 July & August / PCWorld_2007-07-08_cd.bin / v cisle / jpegcomm / edjpgcom.exe / readme.txt < prev   
Text File  |  2002-01-05  |  7KB  |  171 lines
  1. edjpgcom is a free Windows application that allows you to change (or
  2. add) a JPEG commment in a JPEG file. That's all it does. All other
  3. fields in a JFIF or Exif file are left untouched. It even keeps the
  4. filesystem timestamp! It's based on the rdjpgcom and wrjpgcom
  5. utilities from the Independent JPEG Group's 6b distribution. (Heck,
  6. it's essentially these two programs combined with a basic dialog
  7. control.)
  8.  
  9. Installation:
  10. -------------
  11.  
  12. Copy the executable egjpgcom.exe someplace convenient. It's
  13. completely self contained and uses no registry entries.
  14.  
  15. Usage:
  16. ------
  17.     edjpgcom "filename.jpg"
  18.  
  19. The quotes around the filename are *required* (Don't ask.)
  20.  
  21. A dialog will popup. The text area will contain any existing comment
  22. text. You can cut and paste using the usual Ctrl-C, Ctrl-V,
  23. Ctrl-X. If you press OK, this text will be added to your file and a
  24. backup file will be created with the same name as your file but with a
  25. ".bak" added. If you don't want this backup file, check the 'Delete
  26. Backup?' checkbox. Of course pressing Cancel will exit without doing
  27. anything. 
  28.  
  29. If you want to delete a comment, just delete all the comment text. 
  30. Edjpgcom will then delete the comment section. 
  31.  
  32. Now I don't really expect this program to be used from the command
  33. line. Instead, I assume that you will add it to either the external
  34. programs list of another editing/managment program OR add it to the
  35. context menu for JPEG files in windows.
  36.  
  37. NOTE: Changing file associations akin to editing your registry. 
  38. Be careful and be sure you know how to undo anything you might 
  39. have done.
  40.  
  41. For example, in Windows 98:
  42. * open Windows Explorer
  43. * View -> Folder Options
  44. * select the "File Types" tab
  45. * Find and select the JPG file type(s)
  46.     NOTE: Sometimes you may not be able to find the JPG File types
  47.     If this happens see below.
  48. * press the "Edit" button
  49. * press the "New" button
  50. * for the "Action:" enter 
  51.   Comment
  52. * for the "Application used..." enter
  53.   "c:\full\path\to\edjpgcom.exe" "%1"
  54. where the quotes are important (if you do not use quotes around the 
  55. program path name, Windows may assume only short filenames can be 
  56. passed to the program) and replacing c:\full\path\to with the correct
  57. directory path where you put the executable. 
  58.  
  59. Now "Comment" should appear when you right-click on a JPEG file. This
  60. works well in combination with "View as webpage" or "Thumbnails".
  61.  
  62. In Win2k, the procedure is the same except you get to the 
  63. add action dialog this way:
  64. * Open "Windows NT Explorer"
  65. * Tools -> Folder Options
  66. * select the "File Types" tab
  67. * Find and select the JPG file type(s)
  68. * press the "Advanced" button
  69.  
  70.  
  71. NOTE: Sometimes you may not be able to find the file type associated
  72. with .jpg files. This usually happens after several programs have reset 
  73. your file associations. I use an utility from PC Mag called
  74. "Freedom of Association" to reassign the .jpg extension to a registered type.
  75.  
  76. Another alternative is to add a shortcut to egjpgcom.exe to your Windows 
  77. "Send To" directory. You can then send a file to edjpgcom. It will politely 
  78. refuse to handle a non-jpeg file.
  79.  
  80. If you use ThumbsPlus to manage your photos (highly recommended), you can add 
  81. edjpgcom as an external program using the following steps:
  82. * Right-click on the tool bar to bring up the customization window
  83. * Press the "External Programs" button
  84. * Enter the full pathname to edjpgcom.exe in the Program box.
  85. * Make sure the "Short Names", "multiple files" and DDE are NOT checked.
  86.  
  87. Now you will have an icon on your toolbar and a menu item on the right-click
  88. popup window for image files.
  89.  
  90.  
  91. Template File
  92. -------------
  93. If the environment variable EDJPGCOM_TEMPLATE exists and points to a readable
  94. file, then the contents of this file will be used as the default comment when 
  95. adding a comment to a file that does not already have one.
  96.  
  97.  
  98. License:
  99. --------
  100. Permission to use this software for any purpose, without fee, is
  101. hereby granted. THIS SOFTWARE IS BEING PROVIDED AS IS, without any
  102. express or implied warranty.
  103.  
  104. If you like it send me one of your photos (email or a postcard) at:
  105.  
  106. edjpgcom@yahoo.com
  107. Erik Magnuson
  108. 7490 Windover Way
  109. Titusville, FL 32780
  110.  
  111. Send comments/bug reports to edjpgcom@yahoo.com.
  112.  
  113. How it works:
  114. -------------
  115. When egjpgcom starts, it opens the file, extracts the comments and
  116. then closes the file again. When you press OK, it creates a temporary
  117. file with the same path and filename as the original, but with an
  118. random 3 digit extension instead of ".jpg". It then copies the header
  119. data from the original file, the new comment, and the rest of the
  120. original file to this temporary file. It closes the temp file and
  121. attempts to rename the original file to ".bak". If this succeeds, it
  122. will rename the temporary file to have the original filename. Last, it
  123. deletes the backup file if that options is selected.
  124.  
  125. What this means is that if egjpgcom should crash for any reason, you
  126. should still have your original file (unless you deleted it!). You
  127. might have to clean up a .nnn file but that's it.
  128.  
  129. It's been tested on Win2k, NT 4.0 SP5, Win95a, Win98, and Win98SE. 
  130.  
  131.  
  132. Limitations:
  133. ------------
  134. * The egjpgcom program itself only supports a single filename as
  135. input. However, if multiple files are selected and "Add Comments"
  136. context menu is chosen, multiple copies of egjpgcom will be
  137. started. Hopefully, the filename in the title bar will help you figure
  138. out which is which.
  139.  
  140. * While a JPEG comment field can up to 64k chars, edjpegcom is limited
  141. to 32000 characters by the Win32 edit dialog.
  142.  
  143. * egjpgcom uses the DOS/Windows CRLF convention for line
  144. terminators. It will convert any plain CR or LF to a CRLF pair.
  145.  
  146. * edjpgcom has not been tested with multiple COM sections in a single file.
  147.  
  148. * edjpgcom does not get any comment data from other comment fields like
  149.   Photoshop FileInfo (IPTC/NAA subset)
  150.   Exif ImageDescription
  151.   Exif UserComment
  152.  
  153. * Error messages are primitive.
  154.  
  155. Credits:
  156. --------
  157. This software is based in part on the work of the Independent JPEG Group.
  158. Thanks to Jacob Navia for lcc-win32.
  159. rec.photo.digital for all the information.
  160.  
  161. History:
  162. --------
  163. 17 Feb 2001    v0.1 foisted upon an indifferent world
  164. 19 Feb 2001    v0.2 Fixed Win9x file creation timestamp (well, it worked on Win2k!)
  165. 10 Apr 2001    v0.3 Deletes comment section if empty comment entered
  166.              Does not write file is comment text unchanged and "OK" pressed.
  167.              Added a simple program icon.
  168. 19 Dec 2001     v0.4 Larger dialog box size
  169.                      Defaults to delete backup
  170.              Optional template file if empty comment block.
  171.